To create a new document, select "New" from the "File" menu. A new, blank window will appear on your screen.
You can define new document settings, such as window size, font type, and background color, by going to the "File" menu, selecting "Preferences" and then choosing "New Document". To read more about defining these variables refer to "Chapter 3 - Preferences".
2.2 Files that Jedit3.0 can Edit
Jedit3.0 is designed to edit the following text files:
Plain Text (Mono Style Text)
Text data only. (Plain text refers to text data in the
narrowest sense)
Styled Text
Text data that includes font type, font size, font color
and font style.
Jedit3.0 can edit Styled Text created by SimpleText.
Read Only Text for SimpleText
Styled Text that includes picture data with following icon.
SimpleText can only open and read this file. It cannot edit it.
Jedit3.0, however, can open and edit this type of file.
WASTE Text
Styled Text that includes sounds, pictures, and other
objects.
WASTE Text is a text format that comes from the WASTE
Text Engine created by Mr. Macro Piovanelli. Many editor
programs, including Jedit3.0, use WASTE Text Engines.
To view a list of editor products that use the WASTE
Text Engine, go to:
http://www.boingo.com/waste/
Our previous Jedit program, Jedit2.0, could only edit plain text. Jedit3.0 is a much more powerful program since it can read, edit, and save all four types of text files shown above.
Though the line break code of MacOS is "CR", Jedit can read and save document files that use different codes of other operating systems, as follows:
3 Types of Line Break: Macintosh(CR), UNIX(LF), DOS(CR+LF)
Jedit also can read and save the Unicode and UTF8 text whose first 2 bytes of text are 0xFEFF( ZERO-WIDTH NO BREAK SPACE).
In the Japanese Text, Jedit supports the following types of kanji encodings even though the default (standard) kanji encoding of MacOS is shift-JIS.
Jedit can find the type of kanji encodings in opening files and automatically converts to default encoding.
If you don't handle the Japanese text, please set the option "Judge Kanji Encodings" of Preferences to OFF. Because it may misjudge the high ASCII Roman text as Kanji text.
If the encoding or the type of line break were not Mac's default set, Jedit displays the following alert message *1. If you want to convert the document, push "Convert" button.
*1 If you do not want to see the above alert messages, push the buttun "Don't alarm from now on" or got to "Preferences" and turn this option off.
In Judgement of Kanji Encodings, Jedit may works correctly in most cases. However, it may fail to judge when the document contains a limited number of words, or only specific words. For example, with documents that were built using only Hankaku Katakana, it is difficult to determine between the shift-JIS (MacJapanese) and EUC Encoding. In such cases, the following dialog box will appear, allowing you to manually select the appropriate encoding.
<<Note on CIS-JIS Kanji Encoding >>
Jedit3.0 judge CIS-JIS kanji encoding if the document contains '~y' or '~z'.
However, some URLs or home directory strings in UNIX may contain '~y' or '~z', in which cases Jedit3.0 will mistakenly judge as the CIS-JIS kanji encoding. Therefore, we recommend that you turn off "Judge CIS-JIS Kanji" in preferences, unless you are opening a document that uses CIS-JIS. (CIS-JIS is minor encoding that is used by the Japanese forum of CompuServe.)
2.3 Opening Documents
There are four ways to open document files using Jedit.
(1) Double click on the Jedit3.0 document.
The icon below represents a Jedit document file. If you double click on this icon, Jedit automatically starts up and opens the file.
(2) Dragging & Dropping document files on Jedit3.0 Icon.
Any text file, including non-Jedit documents, can be opened using drag & drop. If the document is not a text file, the following alert message appears. The alert dialog will not appear if you hold down the option key while dragging & dropping the document file.
*Jedit is designed to edit text files only. When using the option key, there is no way to be sure if you are opening a text or non-text file. This function should only be used when opening text files that have a file type other than "TEXT" for whatever reason.
(3) Opening a document file.
Select "Open..." from the "File" menu to open a certain text file. To open a none-text document, hold down the option key while choosing the menu.
You can choose a classic File dialog or Navigation Service File dialog by selecting "General" from preferences. A Navigation Service is available in MacOS 8.5 or later.
Navigation Service Open Dialog Box
To preview the beginning of a selected file, push "Show Preview" button.
If you check the checkbox "Auto Judge", Jedit3.0 will automatically judge its kanji Encoding and line break. If the file is not MacOS's default encodings, Jedit3.0 automatically converts the file so that it can be viewed in the preview window.
If you don't check the checkbox "Auto Judge", you can manually specify "Encodings" and "Line Break". We recommend that you check off "Auto Judge" when Jedit3.0 can't judge the correct encoding.
(4) Select "Recently Opened Files..."
If you select the menu "Recently Files...", a list of recently opened files will appear, with the most recent file listed on top. Then select the file you want to open. This is a quick, easy way to view recent files. To change the maximum number of files displayed on this menu, select "Open" from "Preferences". The default number is "15."
If you want to remove a file name from this menu, simply select the name of the file with the option key down.
2.4 Saving Documents
Select "Save" from the "File" menu to save a current document.
When the current document has not been saved or when you select "Save As...", the following save dialog will appear. Select the folder where you want to save and input a file name.
Navigation Service Save Dialog
You can specify the type of file by the pop-up menu "File Type".
Choosing "Same As Original", the document will be saved in the same file type as the original file that you opened.
Choosing "Jedit3 Normal", the document will be saved in the Jedit3.0 file type with following icon:
Choosing "Jedit3 Text Only", the document's data fork is only saved in Jedit3.0 file type but its resource fork. (i.e. the document is saved as a plain text file.) Any specific data in resource fork, such as fonts, styles, images , the cursor position and window size, are not saved. By saving documents in this manner, you can save some disk spaces.
Choosing "SimpleText", the document will be saved in the Simple Text file type with the following icon:
When you choose "SimpleText Read Only", the document will be saved as the read only SimpleText file with the following icon:
SimpleText program can not open a text file that has more than 32KB. If you choose "SimpleText" or "SimpleText Read Only" to save a large file, the following alert box will appears:
Though MacOS's default encoding is MacRoman (Shift-JIS) and line break is CR, Jedit can save in other encodings and line breaks by selecting pop-up menu "Encodings" and "Line Breaks".
Encodings Line Breaks
To save in MacRoman or MacJapanese encoding, choose "Mac". You can also save Roman text in Unicode/UTF8 encodings. Encodings of "JIS", "EUC", "NEC-JIS", "ACOS" and "CIS-JIS" are only valid in the Japanese text. Don't choose those encodings in non-Japanese text.
2.5 Saving Highlighted Areas
To save part of a current document, select the area you want to save in the current window, and choose "Save Selection..." from the "File" menu. Input a file name to save the file.
If you want to append the selected area to a file that already exists, check "Append" in the file dialog box.
2.6 Revert
If you want to discard all changes made since the last time you saved the file, Choose "Revert" from the "File" menu.
2.7 Closing Windows
To close the active window, select "Close" from the "File" menu. You will be prompted to save any changes you have made.
If you desire to quickly close all open documents, hold down the option key while closing the active window.
2.8 Import
You can insert objects from another files into the cursor location of the current document by choosing "Import" from the "File" menu. Six kinds of objects can be inserted, including texts, sounds, images, QuickTime files, QucikDraw3D files and aliases.
You may also drag & drop the objects directly into the active window. Since it is a lot easier to insert objects this way, you should use the drag & drop function when possible.
To insert text files using the file menu (text files include plain text, styled text, and read only texts of SimpleText and WASTE text), select "Text File...".
To insert Sound Resources, choose "snd Resource...". You will then be prompted to select the file that includes the 'snd ' (sound) resource you want to insert. After you specified the file, choose the snd resource to insert using the following dialog box:
By pushing "Import" button, the following icon will appear in the document.
If you double click on the above icon right now, you will hear its sound. The sound resources are usually contained in system file, application files and sound files of following icon:
To insert PICT resources, select "PICT Resources..." You will then be prompted to select either a PICT file, or a file that includes PICT resources. PICT files usually have the following icon:
If you choose the file that includes PICT resources, next you will be prompted to select PICT resource by the following dialog:
Click "Import" after you select the image to insert.
If you choose "QuickTime.." or "QuickDraw3D", you will be prompted to select the QuickTime file or QuickDraw3D file you want to insert. File Icons for QuickTime and QuickDraw3D files look like the following:
QuickTime Movie File QuickDraw3D File
To play the QuickTime Movies or QuickDraw 3D Movies, double click on the imported object you want to play.
If you choose "Alias...", you will be prompted to select the original file to be aliased. After making the selection, an alias object will appear in the current document.
The original file or original folder will open when you double click on the alias objects in the document as same as alias icons in Finder. If the original file cannot be located, you will be prompted to indicate where the original file or folder exists. Select the original from the following file dialog A blank icon will represent the alias that does not connect to an original file or folders.
You can change the original file of the alias object by double clicking on the alias with the option key down.
If the current document is HTML (i.e. HTML coloring is active), "Path Name..." will appear instead of "Alias..." in the Import menu.
Selecting "Path Name..." will allow you to insert the path names* for the files you select. This is useful when you need to insert anchor or image tags.
*The path name will be converted to a URL when inserted. Space, back-slashes(\), non-ASCII characters (kanji, Hankaku-katakana and others), and special symbols(< > [ ] { }^ ` | ~) will be converted to HEX codes with %.
2.9 Exporting Objects
To save an object as an individual file, select the object (sound, image or others), then choose "Export Objects..." from the "File" menu.
Sounds will be saved in a sound file.
Images will be saved in a PICT file.
QuickTime objects will be saved in one of the following:
BMP, DV Stream, PICT or movie file.
QuickDraw3D objects will be saved in a 3D movie file.
Aliases and path names can not be exported.
2.10 Document Information
To view document information, choose "Document Information..." from the "File" menu. The following window will display information for the selected area, as well as the entire document.
Information data are recalculated when the information window comes to front. Note that data are not refreshed while the information window stays in background.
"Text" refers to the byte size of the current document. (Style data and objects are not included.)
"Paragraphs" is the number of paragraphs contained in the document. Every carriage return will be counted as one paragraph.
"Lines" refers to the number of physical lines that appear in your document window.
"Words" refers to words count. In Japanese text, words count is meaningless because Japanese sentences usually don't contain white spaces.
"Character Count" refers to the number of characters in the document. Both 1-byte and 2-byte characters will be counted as one character. However, control characters (such as tab or line break ) will be excluded from the count.
"Image", "Sound", "QuickTime", "QuickDraw3D" and "Alias" all refer to the number of such objects contained in the document, respectively.
2.11 Printing
Select "Page Setup..." from the "File" menu to set up the appearance and layout of the printed page.
Select "Print..." from the "File" menu to print entire pages from the current document.
If you select "Print One" from the 'File" menu, a single copy of the current document will be printed.
To print a portion of a document, select the area to print, and choose "Print Selection..." from the "File" menu.
Paper width and document width
When the document width is set to "follows the window width" in "Format" menu, printing line width also will follow the paper width. In such cases, printed image may not appear the same as the image of document window because of the difference between window and paper width.
If you select "Fixed width" at "Document width..." of the "Format" menu, line width on the printed document will be the same as the document width in the window. Therefore, the printed image will appear the same as the document in your window.
If you have checked "Wordwrap follows the paper width" in "Print" Preference, printing line width will follow the paper width, regardless of whether or not you select "Fixed width" at "Document Width..." of "Format" menu.
You may also make the print setting in the "Print" of "Preferences". ( For details, see "Chapter 3, 3.6 Print Settings".)
